Internet Info 1994 March

home *** CD-ROM | disk | FTP | other *** search

/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / b / ikcker.bwr < prev next >

Wrap

Text File | 1993-01-22 | 47.2 KB | 878 lines

CMS Kermit 4.2.x "Beware File" - Known Bugs, Problems, Limitations. As of: 12:12pm Friday, 1993 Jan 22 This file contains (A) instructions for applying Kermit updates, (B) a list of unresolved problems, (C) a list of problems with work-arounds or optional fixes, and (D) a list of resolved problems. NOTE: entries will sometimes be entered under (D) even though the needed updates have not been released in IKCKER.UPD. Please check the date of the UPD file to see if it has been changed before requesting a new copy. Bug reports should be sent to John Chandler <JCHBN@CUVMB.CC.COLUMBIA.EDU>. Kermit-370 carries an "edit" number in addition to the version and release numbers. The three numbers together are printed out in the assembly listing and displayed by Kermit at startup time. Be sure to include all three numbers (e.g., 4.2.3) along with any error reports. A) Update instructions ................................................. Many updates have been received since Kermit-370 4.1 was released. All updates prior to 90/4/14 have been removed from IKCKER.UPD and applied to the sources in the process of creating 4.2. If your source does not include the line defining &KVRSN to be 4.2, you should obtain an all-new source distribution from Columbia. Any updates created later than your source should be applied before you make the executable module. In general, updates received at Columbia will not be included in the source files in the CMS Kermit distribution until and unless "major" bugs are uncovered, and then all accumulated updates will be applied at once. The description of each problem and a pointer to its solution will always be included in IKCKER.BWR (the present file), but the updates themselves are to be found in IKCKER.UPD or IKCXA.UPD. The latter file contains the updates related to VM/XA or VM/ESA. The procedure to update your copy of CMS Kermit is as follows: 1) Obtain the latest version of IKCKER.UPD, which contains all the updates, each preceded by a separator beginning ":READ" and giving the update's name. Please note that some modes of file transport have a side effect of either doubling or removing any periods in the first column -- if your copy of IKCKER.UPD has records beginning with "/", then all instances of "/" in column 1 should be changed to "./". Similarly, any instances of ".." in columns 1-2 should be changed to just ".". A related problem can affect the sources by leaving a blank in column 80. That can happen via the loss of a "." in column 1 (in which case the sequence number will be shifted into columns 72-79) or via automated efforts to preserve the "." (in which case the sequence number will be truncated). The repair consists of inserting the missing "." in column 1 or "0" in column 80 -- there are currently only two such lines that do NOT have "0" in column 80: they begin .CMSXA2 and .CMSXA3, respectively, and should each end in "5". Also, obtain IKCXA.UPD if you wish the VM/XA or VM/ESA version. 2) Determine the date of your sources. If you obtained the source from Columbia, the date is the value of the &KDATE variable symbol in the source itself, i.e., the release date of the current base version. If you received the source distribution from a secondary supplier, you will need to examine the code to determine the most recent update applied. Just sort the combined source by columns 67-71, e.g., using :1 SORT * A 67 71 in XEDIT; the last line will be labeled with the last-applied update. 3) If your sources are "pure" Columbia 4.2, go on to step 4. Otherwise, you must take care to avoid applying updates that are already in the source. If it is inconvenient to obtain "pure" sources, you must go through the list of updates (the "AUX" file) at the beginning of IKCKER.UPD (arranged in reverse chronological order) and note which ones are already included in (i.e., are older than) your sources. Disable each such redundant update by inserting an asterisk in column one of the relevant line in the AUX file. If you wish, you may also discard the update itself by deleting the lines from the corresponding :READ up to (but not including) the next :READ. 4) Separate the updates into individual files. This operation is done automatically when you run IKCINS EXEC (included in IKCKER INS). 5) Extract any desired optional updates from IKCKER.BWR (this file) and insert their names into KERMIT AUXOPT, which is reserved for such optional, local updates. The first line of each update, if stripped of the leading "./ * ", will serve as a useful entry in an AUX file. If you have local modifications specific to your site, these should also be listed in KERMIT AUXOPT. NOTE: all updates in this BWR file are indented one column to avoid all the transmission problems mentioned above in step 1. Be sure to shift everything over when you extract the updates. You may bundle the updates together with the AUXOPT into a single file called KERMIT LOCAL (for ease of keeping track) in the same format as IKCKER UPD. When you run IKCINS EXEC, it will automatically split the local updates into the individual files and apply them. 6) Apply the updates to your composite source. This is automatically done by IKCINS EXEC. You may, instead, do it by hand via one of: a) UPDATE KERMIT (CTL b) UPDATE KERMIT ASSEMBLE A KERMCMS6 (CTL c) UPDATE KERMIT ASSEMBLE A KERMXA (CTL d) UPDATE KERMIT ASSEMBLE A KERMXA21 (CTL e) UPDATE KERMIT ASSEMBLE A KERMESA (CTL The resulting file, $KERMIT ASSEMBLE A, represents the latest source, but you should archive the original components IK*.ASM until a new release comes from Columbia. ------------------------------------------------------------------------ B) Unresolved problems/warnings ........................................ ---------------- 89/1/20 ----------------------------------------------- Now that Kermit-370 supports multiple-filespec SEND, it is possible for a single SEND subcommand to specify overlapping wildcard filespecs. Only the CMS variant keeps track and makes sure that it doesn't send the same file twice within one SEND invocation. Indeed, with CMS Kermit-370 it is possible to get a mysterious "file not found" message simply because all the files matching the filespec in question had already been sent in the same invocation. A related limitation applies to the new send-by-line-range option -- you cannot send several different pieces of the same file by one SEND subcommand, since the duplicate-suppression logic pays no attention to line ranges actually sent. ---------------- 90/5/8 ------------------------------------------------ With a few exceptions, CONTROLLER will be set automatically when Kermit is invoked. See file IK0AAA.HLP in the Kermit distribution for a list of front ends that have been reported to allow Kermit file transfers and another list of reported failures. ---------------- 91/8/16 ----------------------------------------------- The type-out interception mechanism for server mode works only for "normal" line-oriented output, not for fullscreen applications. Indeed, since there is no mechanism provided for feeding subcommands to a program on the mainframe through the Kermit server, only one-shot, non- interactive commands should be issued via REMOTE HOST. ---------------- 92/10/13 ---------------------------------------------- Like all variants of Kermit-370, Kermit-CMS does not support mixed-case file ids. Starting at CMS Rel 4, there has been partial support in CMS for mixed-case ids via the CMS SET INPUT command, but Kermit ignores the SET INPUT translations, if any. ------------------------------------------------------------------------ C) Problems with workarounds or optional fixes ......................... ---------------- 87/7/2 ------------------------------------------------ Subject: Using KERMIT with an IBM 3708 and VCNA In protocol conversion mode on the 3708, you can use Kermit FULLSCREEN mode for file transfer (see below). However, in protocol enveloping mode, you must go through 6 separate steps to get things working. Briefly, they are as follows: 1) Apply IBM APAR DY30352 to bypass VCNA translation tables. 2) Apply IBM APAR II01192 to increase the length of a 'line' for a TWX- type terminal to 80 bytes instead of 72 bytes. 3) Set the packet length on both sides of KERMIT to 80 bytes. 4) Change DTIPDODR source code for VCNA to skip the addition of a 'CRLF' on the front of any line beginning with 02 (CNTRL B). 5) Require that both sides of the link use 02 (CNTRL B) as the start- of-packet character. This is because the 3708 interprets the normal start-of-packet character (CNTRL A) as an attention signal. 6) Use the alternate translate table provided on the 3708, which allows for more accurate transmission of some control characters. ---------------- 87/8/9 ------------------------------------------------ CMS Kermit issues its default prompt by means of the PROMPT option of the CMS TYPLIN function. In so doing, it subjects the prompt buffer to translation via the user's current CMS SET OUTPUT tables such that the changes persist. It is wise to avoid using characters subject to OUTPUT translation in the Kermit prompt. ---------------- 89/2/27 ----------------------------------------------- The code for detecting the difference between SERIES1- and GRAPHICS-type terminal controllers may cause peculiar error messages at session startup, particularly if you try to run Kermit on an IBM 3270-type terminal. Typically, you would see a PROG470 error, but PROG755 is also possible on SDLC/DFT connections. Normally, Kermit can recover from these error conditions, but some configurations and/or versions of VTAM may hang the terminal session instead. For example, there may be an error message IKT00405I SCREEN ERASURE CAUSED BY ERROR RECOVERY from VTAM that never goes away. If you cannot persuade VTAM to be more sensible, you might want to bypass the code (especially if you don't have any GRAPHICS-type terminals). The code is governed by a set of switches which can be tailored to your needs: STCQBIT EQU X'01' WSF Query is always allowed STCQNS1 EQU X'02' WSF Q implies *not* SERIES1 STCS1 EQU X'04' Always assume SERIES1 STCNOS1 EQU X'08' Always assume *not* SERIES1 STCNORD EQU X'10' Asynch READ MOD is forbidden The standard flag value on CMS is STCQNS1; if you wish to force the code to select SERIES1, you should change that to STCS1, as in the following: ./ * SC9131X - Customize controller type selection ./ R 01085200 $ 1085200 100 11/21/91 00:16:50 &CONOPTS SETC 'STCS1' SETCON options @SC9131X Alternatively, if you have *only* GRAPHICS-type controllers, you could change it to STCNOS1. ---------------- 89/7/15 ----------------------------------------------- The CMS/XA Kermit source can't be assembled with the F or VS assemblers, which lack the new XA-mode machine instructions. The H assembler will do. ---------------- 90/6/12 ----------------------------------------------- Speaking of assemblers... Under VM/SP 6 (or thereabout), the STAX macro was imported from MVS to VM's OSMACRO MACLIB with the purely nuisance changes that are incompatible with the VS assembler, and IBM has refused to fix the problem. Moreover, the version of STAX in TSOMAC MACLIB is incompatible with the H assembler. Thus, if you switch assemblers, you must also switch the order of MACLIB's. ---------------- 90/7/5 ------------------------------------------------ Kermit-370 now honors the file type specification (binary or text) given by a sending Kermit in an Attribute packet. Old procedures for sending binary files may therefore not work properly anymore. To return to the old mode of operation, issue the subcommand SET ATTR TYPE OFF. To live with the new mode, be sure to issue the SET FILE TYPE to both sending and receiving Kermits (to be safe). ---------------- 90/7/30 ----------------------------------------------- When the file type is TEXT and the recfm is F, Kermit-370 strips off trailing blanks from each record before sending a file. In order to keep trailing blanks in a downloaded file, you can convert it to RECFM V in CMS before sending it, e.g., by using COPYFILE with the RECFM V option. This is true of versions from 4.1 onward. ---------------- 90/8/22 ----------------------------------------------- If, for some reason, the other Kermit insists on pretending ASCII bytes all have the 8th bit set, Kermit-370 will not detect the intended CRLF separators between lines. The result of uploading from such a Kermit is a (text) file with only one record. If the other Kermit cannot be fixed, the following update will make Kermit-370 treat ASCII 8D and 8A the same as 0D and 0A, as long as the ATOE table does so. ./ * SC90151 - Forgive 7-bit ASCII files with 8th bit on ./ I 02490500 $ 2490700 200 08/03/90 16:06:46 ISW78 DC X'7F' Start with 7-bit ASCII @SC90151 ./ I 02713500 $ 2713700 200 08/03/90 16:06:46 SW78 DS X'7F' Switch for 7-bit/8-bit ASCII @SC90151 ./ I 03436000 $ 3436500 500 06/01/90 13:24:03 KCALL TBLCRLF Note current treatment @SC90151 ./ I 03442000 $ 3442500 500 06/01/90 13:24:03 KCALL TBLCRLF Note current treatment @SC90151 ./ I 04318000 $ 4318500 500 06/01/90 13:24:03 KCALL TBLCRLF Reset 7-bit/8-bit mask for CRLF @SC90151 ./ I 04386000 $ 4386080 80 06/01/90 13:24:03 * * Entry: nothing special @SC90151 * Exit: SW78 set up correctly @SC90151 TBLCRLF ENTER ALT @SC90151 MVI SW78,255 Assume 8-bit codes @SC90151 CLC ATOE+ALF(1),ATOE+ALF+128 @SC90151 BNE RTRN0 @SC90151 CLC ATOE+CR(1),ATOE+CR+128 @SC90151 BNE RTRN0 @SC90151 MVI SW78,127 No, 7-bit codes @SC90151 B RTRN0 @SC90151 ./ I 08048000 $ 8048400 400 NC CUR,SW78 If 7-bit ASCII, ignore 8th bit @SC90151 ---------------- 91/11/21 ---------------------------------------------- In order to change the default Kanji encoding from IBM-style to another, add one of the following updates. ./ * SC9132X - Change Kanji default ./ R 01411560 $ 1411560 10 11/21/91 @SC9132X &KNJDEF SETC 'HITACHI' Default Kanji @SC9132X ./ * SC9132X - Change Kanji default ./ R 01411560 $ 1411560 10 11/21/91 @SC9132X &KNJDEF SETC 'FUJITSU' Default Kanji @SC9132X ---------------- 92/4/10 ----------------------------------------------- The minimum size of strings to be subjected to run-length encoding may need to be changed to two to make the new FULLSCREEN mode work on certain protocol converters, such as the MICOM 7400, which convert three successive blanks into cursor motion commands (or even two!). The following update accomplishes that. ./ * SC92101 - Encode multiple blanks ./ I 07929000 $ 7929050 50 04/10/92 17:35:12 CLI 0(8),ABL Is it a blank? @SC92101 BNE ENCRP1 No, use normal criterion @SC92101 C 14,F2 @SC92101 BNL ENCRP2 Always encode multiple blanks @SC92101 ENCRP1 DS 0H @SC92101 ./ I 07929600 $ 7929800 200 04/10/92 17:35:12 ENCRP2 DS 0H @SC92101 ---------------- 92/3/10 ----------------------------------------------- Under VM/XA (and presumably under VM/ESA), a CP SLEEP no longer ends if the user enters data and then presses ENTER. Instead, CP treats the string as a command and issues an error message if the string is not a valid CP command (e.g., is a Kermit packet). For TTY and FULLSCREEN modes, then, the DELAY should be set to a small value to ensure that the micro Kermit never times out before Kermit-CMS can send the first packet. ---------------- 92/3/16 ----------------------------------------------- Ordinary CMS Kermit cannot download files from the Shared File System that comes with CMS Releases 6 and higher because the new FST blocks are longer. Kermit can also run into problems during uploads with the SPACE attribute checking mechanism. The code necessary to handle these things is present, but is normally suppressed because it cannot be assembled properly under pre-6 CMS. To enable the code, use KERMCMS6, KERMESA, or KERME370 CNTRL file for applying the updates, whichever is appropriate. ---------------- 92/10/13 ---------------------------------------------- There is a bug in CMS Rel 7 and 8 affecting the CMS ERASE command when issued by typing the command at Kermit-CMS. The symptom is that the file id is taken by ERASE exactly "as is", with neither the normal up- casing done by Kermit nor the translation, if any, according to the CMS SET INPUT commands. The bug is listed by IBM as APAR VM48775, and the fix (to CMS) has been available since June of 1992. Alternatively, the following update may be applied to Kermit-CMS to avoid the problem. ./ * SC92244 - Bypass ERASE bug in VM/ESA (CMS) ./ R 05465000 $ 5465000 100 09/02/92 12:07:36 ICPCMSX DS 0H @SC92244 AIF ('&KTAG' NE 'XA').CMSXA1B @SC92244 L 6,ASVCSECT Since we searched... @SC92244 DMSEXS OI,SVCCMDRS-SVCSECT(6),SVCCSRCH set search bit @SC92244 .CMSXA1B HOST 0(3),E=*+4,EPL=YES Accept errors, use ext.PL. @SC92244 ---------------- 92/11/10 ---------------------------------------------- In the IOCP gen on the ES9000, there is a SHARED option on the CNTLUNIT macro in the IOCP gen. It must be set to SHARED=YB for a 7171. ------------------------------------------------------------------------ D) Resolved problems ................................................... ---------------- 89/9/3 ------------------------------------------------ CMS Kermit works under VM/XA and VM/ESA. The set of updates to allow XA-mode or ESA-mode operation is available as a separate file called IKCXA.UPD (as a supplement to IKCKER.UPD). The XA-tolerant Kermit will still work correctly in 370 mode of CMS 5.5, 5.6, 7, or later, but will not work with earlier releases of CMS (because CMS did not then support SVC 204). ---------------- 90/5/8 ------------------------------------------------ A commonly reported "problem" is that Kermit-CMS objects to a send packet size greater than 94, and users wonder how to turn on long-packet protocol for downloads. The answer is that the the maximum packet size in Kermit protocol is always dictated by the receiving Kermit -- ALWAYS. NOTHING YOU CAN SAY TO A SENDING KERMIT WILL EVER MAKE IT SEND PACKETS LONGER THAN THE RECEIVING KERMIT ASKS FOR. Conversely, Kermit-CMS will always use packets as long as possible unless frequent transmission errors indicate a noisy communication line. The only purpose for the send packet-size parameter in Kermit-CMS is to set the default, in case the receiving Kermit is badly crippled (in which case, long packets are entirely out of the question anyway), or to control "raw" downloads (those without Kermit protocol and parameter negotiation). ---------------- 90/5/8 ------------------------------------------------ Kermit-370 is often faced with a communication front end that treats an XOFF from the other end as an end-of-line. Thus, in server mode, it may receive "packets" consisting of XON XOFF or just XOFF when the micro issues flow control for purely precautionary reasons. Such packets are now ignored, rather than treated as invalid server commands. The fix: SC90106. ---------------- 90/5/14 ----------------------------------------------- Kermit-370 is now careful not to attempt to send packets longer than the (system-specific) hardware maximum. The fix: SC90134. ---------------- 90/5/30 ----------------------------------------------- Kermit-370 now accepts PACKET-LENGTH as an alias for PACKET-SIZE in SET SEND or SET RECEIVE. The fix: SC90150. ---------------- 90/6/10 ----------------------------------------------- Kermit-370 now supports transfers in LATIN2 and LATIN3 and file storage in CP870, CP880, and CP905. In addition, L1, L2, and L3 are recognized as aliases for the three LATIN sets, and two-character abbreviations are accepted for the other transfer sets as well. The new sets add support for Afrikaans, Albanian, Catalan, Croatian, Czech, Esperanto, Galician, Hungarian, Maltese, Polish, Romanian, Slovak, Slovene, and Turkish. The fix: SC90152. ---------------- 90/6/22 ----------------------------------------------- Kermit-370 supports file transfers through the IBM 3174 AEA with level 2 microcode in configuration B. The support is restricted to terminal types defined in the 3174 to have ASCII Graphics capability. That capability is available by default only for VT241 and Tektronix 4205 terminals, but user-defined terminal types are also possible. Also, the Graphics capability is allowed only for lines defined without associated Host Addressible Printers. Kermit-370 now automatically detects the B2 AEA and sets CONTROLLER accordingly (to AEA if Graphics is allowed, to NONE if not). However, if the 3174 is owned by VTAM, and the connection is made with a logmode that forbids the Read Partition Query (such as M2SDLCNQ), Kermit cannot detect the AEA and will default to CONTROLLER GRAPHICS (and, incidentally, cannot transfer files even with CONTROLLER set to AEA by hand). M2SDLCQ is known to allow correct operation, but other logmodes have not been tested. Since the 3174 supports full 8-bit communication, it may be useful to configure the ports for 8-bit data and to set both SEND and RECEIVE PARITY to NONE in Kermit-370. The fix: SC90173. Note: B2 microcode became available from IBM in May 1990. B3 followed soon afterward, and it supports file transfer the same way as B2. ---------------- 90/6/28 ----------------------------------------------- Kermit-370 now gives correct status reports after an XTYPE, rather than retaining the error code, if any, from a previous transfer. Also, XTYPE now supports the full, extended syntax of SEND. The fix: SC90179. ---------------- 90/7/30 ----------------------------------------------- Kermit-370 now uses the FILE COLLISION settings for all files in a group rather than just the first. The fix: SC90211. ---------------- 90/8/14 ----------------------------------------------- When DEBUG is set to I/O, Kermit-CMS now includes the hex dump of the CSW and data buffer in KER LOG, even when an I/O error is detected. Also, the Attention bit is no longer set in the CSW dump merely to indicate that Kermit has seen an Attention interrupt -- an extra byte is now used for that purpose. The fix: SC90222. ---------------- 90/8/27 ----------------------------------------------- Kermit-370 now has three new subcommands: REMOTE MAIL, REMOTE PRINT, and REMOTE SUBMIT. They transmit a file (or group of files via wild cards) tagged for mailing, printing, and submitting as job, respectively. The syntax is: REMOTE MAIL/PRINT/SUBMIT filespec options The options are passed to the receiving Kermit and must be in a format it will understand. The fix: SC90239. ---------------- 90/8/27 ----------------------------------------------- Kermit-CMS is now at level 4.2.1. The fix: SC90240. ---------------- 90/9/7 ------------------------------------------------ Kermit-370 now has a TRANSPARENT transfer character set, which applies a null translation to all incoming and outgoing files. The fix: SC90250. ---------------- 90/9/21 ----------------------------------------------- Kermit-CMS now has a more flexible on-line help facility. To use it requires a more elaborate installation procedure. You have four options: (a) stick with the old form of help, (b) add support for the HELP <subcmd-name> facility within Kermit, (c) add a CMS Help menu for Kermit subcommands, or (d) add both kinds of subcommand help. In any case, the old method of invoking help from within Kermit (by simply typing HELP) has been pre-empted by the new facility -- to get the same effect, you must now type CMS HELP KERMIT (or whatever the filename of the help file and module is). The new IKCKER.HLP is still an unformatted "source" file which should be formatted as before using the HELPCONV utility. If you stop at that point in the installation, you get exactly the same kind of help file as before, but there are now comment lines (of the form ".cm NAME") which demarcate the file into individual help subfiles, and these survive processing by HELPCONV. These separators can be used in two ways. First, the help file can be converted into a PDS so that it can be read by both CMS HELP and the Kermit HELP subcommand. Second, file can be split into subfiles linked by a menu for CMS HELP. The procedure for making the PDS is as follows: 1. Format the help file by entering HELPCONV IKCKER HLP. Rename the output from IKCKER $HLP to KERMIT COPY (or whatever filename you prefer). 2. Using XEDIT on the formatted file, change all occurrences of ".cm" to "*COPY", change the RECFM from "V" to "F", and save the file. 3. Convert the file to a PDS by issuing MACLIB GEN KERMIT KERMIT. 4. Rename the PDS from KERMIT MACLIB A to KERMIT HELPCMS A. If you will call the Kermit module something other than KERMIT, you should give the help file the same filename. The Kermit HELP subcommand uses the resulting help file by issuing a CMS TYPE command for a particular subfile. Thus, while running Kermit, it is possible to enter HELP SERV to get specific help about the SERVER subcommand. For some reason, the CMS TYPE command displays the logical end-of-file marker at the end of a PDS member (x'61FFFF61', which looks like two unprintable characters sandwiched between slashes). These same delimiters are displayed by the CMS HELP command, in addition to some extra records at the top and bottom of the PDS -- these should simply be ignored. On the other hand, if you believe the help file will no longer be used in the old way (via "CMS HELP KERMIT"), you can go back to step 1 above and also remove the lines beginning ".cs", since they are used only in the normal CMS HELP processing and only get in the way of the Kermit HELP subcommand. Splitting the help file into separate files for use with a menu can be done in roughly the same way as splitting the update file apart as described above: the ".cm" lines can be changed into ":READ", and the file can then be split using PUNCH and READCARD or using a variant of the XEDIT macro shown. The fix: SC90264. ---------------- 90/9/27 ----------------------------------------------- Kermit-370 failed to use control-quoting on 8-bit analogs of ordinary control characters if 8th-bit quoting was turned off. The fix: SC90270. ---------------- 90/9/27 ----------------------------------------------- Kermit-370 now suppresses echoing in protocol mode on LU1 3770-type front ends by sending Inhibit/Enable Presentation controls (EBCDIC x'24' and x'14'). These characters should have no effect on "old-fashioned" linemode equipment. The fix: 2L90270. ---------------- 90/9/28 ----------------------------------------------- Some corrections to the Cyrillic translation tables. The fix: SC90271. ---------------- 90/10/4 ----------------------------------------------- Kermit-370 now keeps separate limits on packet buffer sizes for linemode and fullscreen devices and no longer assumes that the latter is always bigger. The fix: SC90277. ---------------- 90/10/5 ----------------------------------------------- Kermit-370 now has a SET TTABLE KP option which enables a full 8-bit translation table based on Hollerith codes. The fix: SC90278. ---------------- 90/10/12 ---------------------------------------------- Kermit-370 now allows testing with a packet character that is not a control character without requiring that the test character be avoided in the data. The fix: SC90285. ---------------- 90/10/16 ---------------------------------------------- Kermit-370 now leaves server mode if packet I/O errors recur. The fix: SC90289. ---------------- 90/10/19 ---------------------------------------------- The extraneous B packet after an XTYPE (introduced in 4.2.1) is now avoided. The fix: SC90292. ---------------- 90/12/4 ----------------------------------------------- V-binary (or D-binary) file transfers trashed the last 2 (or 5) bytes of any record of 65535 bytes. The fix: SC90338. ---------------- 90/12/5 ----------------------------------------------- Kermit-370 now has a VERSION subcommand, which displays the version number and date. The fix: SC90339. ---------------- 90/12/10 ---------------------------------------------- Kermit-CMS now rejects an invalid filemode on a CWD (or SET DESTINATION) subcommand. The fix: SC90344. ---------------- 91/1/8 ------------------------------------------------ Kermit-370 now has a facility for taking snapshot dumps of selected storage blocks during execution and another for tracing events. See SET DEBUG in the User's Guide for more details. The fixes: SC91008 and LM91008. ---------------- 91/1/17 ----------------------------------------------- Kermit-370 now generates a more informative error message if an attempt to open a file for output fails. The fix: SC91017. ---------------- 91/2/1 ------------------------------------------------ Kermit-370 now interprets the terminal input more liberally when looking for possible STOP commands in protocol mode. If the word STOP appears in either upper- or lower-case EBCDIC, rather than ASCII, it is accepted as a valid STOP. This can be useful in recovering from an attempt to start a tranfer through a device that has no transparent mode. The fix: SC91032. ---------------- 91/2/8 ------------------------------------------------ Kermit-CMS now recovers more gracefully from a "stolen" screen in fullscreen transfers. Certain kinds of lock-up are now avoided. The fix: SC91039. ---------------- 91/3/5 ------------------------------------------------ Kermit-370 now displays any extra explanatory error message (such as those for I/O errors) along with the basic message upon completing a subcommand. The fix: SC91064. ---------------- 91/3/8 ------------------------------------------------ Support for lower-case Roman letters has been added to CP290 (Katakana). Some corrections have been made to the LATIN2-to-CP870 table. The fix: SC91067. ---------------- 91/3/22 ----------------------------------------------- Kermit-CMS no longer hangs on screen I/O errors, but rather registers a "Terminal I/O error" condition and eventually escapes from server mode if necessary. The fix: SC91081. ---------------- 91/4/4 ------------------------------------------------ Kermit-370 now processes any incoming Date attribute for validity, even though no variant currently uses it. The fix: SC91094. ---------------- 91/4/5 ------------------------------------------------ Kermit-CMS now avoids the classical VTAM lockup at the start of a SEND caused by having too long a SEND delay. The fix: SC91095. ---------------- 91/4/9 ------------------------------------------------ Kermit-370 now supports an "End-of-attributes" attribute. There is no current application, but its existence should facilitate negotiation of file attributes when it becomes generally supported by other Kermits as well. If another Kermit objects to the new attribute (not likely), you can suppress it by typing SET ATT END OFF. The fix: SC91109. ---------------- 91/4/26 ----------------------------------------------- Kermit-370 now supports a "CC" option along with the line range for sending files. This option specifies that the file has carriage control in column 1 and that it should be converted to ASCII control characters. For example: SEND filespec<_CC> (the underscore is the option delimiter and indicates here that no line range is given). The fixes: SC91116 and SC91224. ---------------- 91/6/14 ----------------------------------------------- Kermit-370 now stops attempting to cancel a received file via the "YX" method after ten tries have been ignored by the sender. At that point, it issues an E-packet saying "Transfer cancelled". The fix: SC91165. ---------------- 91/6/19 ----------------------------------------------- Kermit-CMS now invokes CMS commands in a way that matches the behavior of commands entered directly to CMS. In particular, EXEC's invoked in this way receive the usual up-cased version of the arguments. Also, commands like LISTFILE do not suppress their error messages. The fix: SC91170. ---------------- 91/6/21 ----------------------------------------------- Kermit-370 now records the time of starting each file transfer in the transaction log. Also, the error message for a cancellation includes the reason (if known), both in the transaction log and in error packets. Further, there is a new DEBUG option TIME that causes a time tag to be inserted into each I/O debug log record. The fix: SC91172. ---------------- 91/6/27 ----------------------------------------------- Kermit-CMS now avoids a serious lock-up of the IBM 4994 when a buffer overrun occurs during an upload. The fix: SC91178. ---------------- 91/6/29 ----------------------------------------------- Kermit-370 now supports 8th-bit quoting for the XECHO subcommand, using the same prefix character as in Kermit protocol. The quoting can, thus, be turned off. The fix: SC91180. ---------------- 91/7/10 ----------------------------------------------- Kermit-370 now avoids a long-standing "hidden" bug: transfers no longer fail if DEBUG is set to RAW while long packets are in use. The fix: SC91191. ---------------- 91/7/17 ----------------------------------------------- Kermit-370 now mentions REMOTE PRINT in the remote help display. The fix: SC91198. ---------------- 91/8/19 ----------------------------------------------- Kermit-370 is now at level 4.2.2: SC91231. ---------------- 91/9/4 ------------------------------------------------ Kermit-370 no longer halts a transfer upon seeing a data packet with no data. The fix: SC91247. ---------------- 91/9/13 ----------------------------------------------- Kermit-370 now allows the STOP command on PCI and certain other protocol converters that did not previously support it. The fix: SC91256. ---------------- 91/9/20 ----------------------------------------------- Kermit-370 no longer gives a spurious reason for a cancellation issued by user intervention on the micro. The fix: SC91263. ---------------- 91/9/26 ----------------------------------------------- Kermit-CMS no longer considers it a file name collision if the new file being received is to have the same name as a file on a read-only extension of the destination disk. The fix: SC91269. ---------------- 91/10/2 ----------------------------------------------- Kermit-370 supports locking shift protocol (helps to compress certain files with many 8-bit bytes). The fix: SC91275. ---------------- 91/10/8 ----------------------------------------------- Kermit-370 now avoids looping when a solid terminal I/O error sets in or upon any error at the very end of a transfer (no reply expected). The fix: SC91281. ---------------- 91/10/11 ---------------------------------------------- Kermit-370 now uses the built-in default A-to-E translation table for interpreting Kermit commands in server mode when the transfer character set is TRANSPARENT. The fix: SC91284. ---------------- 91/10/22 ---------------------------------------------- Kermit-370 now suggests changes in some settings if the initialization file(s) haven't adopted the new-and-better values. This avoids changing the built-in defaults. The fix: SC91295. ---------------- 91/11/7 ----------------------------------------------- Kermit-CMS now determines in advance whether a terminal could possibly be attached to a 3174 AEA before attempting to confirm that, since the attempt itself is risky. The terminal type detection code has been moved to the generic part of Kermit-370, except for a few flags that define system-specific limitations. The tried-and-true optional update SC89058 has been revised and renamed SC9131X accordingly (see above the note dated 89/2/27). The fix: SC91311. ---------------- 91/11/8 ----------------------------------------------- Kermit-370 now has a SIMULATE subcommand, which plays back a file giving one or both sides of a file transfer to supply the packets (instead of the communication line). This facilitates testing new protocol features one Kermit at a time. Lines in the "canned" file are ignored if they begin "S:", are translated from EBCDIC to ASCII if they begin "R:", and are taken as "raw" I/O otherwise. SIMULATE automatically reverts to normal packet I/O either at the end of the file or upon detection of an error. The filespec has the same defaults as for the TAKE subcommand. The fix: SC91312. ---------------- 91/11/12 ---------------------------------------------- Kermit-370 now tolerates alternate EBCDIC versions which do not have all the Roman letters at the standard code points. If the source is passed though a filter that consistently translates certain characters to other code points, the resulting executable program will adopt the same convention, and upcasing and downcasing will follow the new pattern. In particular, this may be necessary in Japan on systems that use the codes normally attached to lower-case Roman letters for Katakana. The fix: SC91316. ---------------- 91/11/16 ---------------------------------------------- The language-specific use of one-letter abbreviations of SET options for program logic flow has been generalized by selecting the internal codes independently of the names of the external options. Any given option could, in principle, be renamed without requiring changes outside of the option keyword table itself. In particular, the keywords could all be translated to a language other than English. Character sets names are an exception, and accented letters should be avoided unless the upcasing and downcasing tables are extended appropriately (see SC91316 above). The fix: SC91320. ---------------- 91/11/21 ---------------------------------------------- Kermit-370 now supports file transfers using Japanese Kanji with translation between IBM, Hitachi, or Fujitsu codes and the newly added transfer character set JAPAN-EUC. Since the new translations require large tables, they have been isolated in a new section of the source code IK0KAN.ASM, which can be omitted. The fix: SC91325. Kanji text differs from other kinds of text files in that it has *two* different character sets associated with it, a single-byte character set (SBCS) and a double-byte character set (DBCS). Thus, it may be necessary to specify the subcommand SET FILE CHARACTER-SET twice: first, for the SBCS and, second, for the DBCS. For example, SET FIL CH CP290 and SET FIL CH FUJ would select one possible SBCS (CP290) along with the Fujitsu double-byte set. Other possible SBCS's are CP281, CP500, and H-EBCDIK-DASH. Plain "EBCDIC" is not currently allowed in combination with Kanji. It is important to specify the single-byte character set first. Note: the chosen SBCS may result in EBCDIC/ASCII translations that differ from those performed by the communications front (for non-transparent modes) -- in that case, it is necessary to SET TTABLE ON in order to transfer files. ---------------- 91/12/18 ---------------------------------------------- Kermit-370 has supported file transfer through the IBM 3174 AEA since release 4.2.1, but some conditions could hang a session after finishing a download. The fix: SC91352. ---------------- 92/1/3 ------------------------------------------------ The old form of non-library help file (see SC90264 above) is once again transparently supported (there is only a momentary flash of the warning message that the help file is not a library). The fix: SC92003. ---------------- 92/1/30 ----------------------------------------------- Kermit-370 has a new FULLSCREEN controller type (the same name as a type that already existed, but served as a synonym for VTAMTTY for historical reasons). The new mode allows Kermit file transfers in a generic way on many different kinds of protocol converters, but it carries some special limitations -- packets cannot be longer than 80 bytes, and the other end must be MS-Kermit 3.12 or higher or possibly C-Kermit 5A.179 or higher. See IK0423.HLP for details on the new mode. The fix: SC92030. ---------------- 92/1/31 ----------------------------------------------- Kermit-370 is now careful to say "unknown" as the reason for cancelling a transfer halted by typing STOP. The fix: SC92031. ---------------- 92/2/21 ----------------------------------------------- The minimum size of strings to be subjected to run-length encoding has been made into a parameter in the Definitions section. The default setting, as before, is 3. Changing it to 2 may be needed to make the new FULLSCREEN mode work on certain protocol converters, such as the MICOM 7400, which convert three successive blanks into cursor motion commands (or even two!). See part C above for such an update. The fix: SC92052. ---------------- 92/3/4 ------------------------------------------------ Getting out of server mode by entering STOP no longer requires hitting ENTER an extra time. The fix: SC92064. ---------------- 92/3/12 ----------------------------------------------- The Hydra II tends to lock up upon receiving an Erase-Write command with no data. Kermit-370 formerly used such a command to condition the screen for an XECHO or XTYPE or to start Kermit protocol mode when DELAY was set to 0. The problem is now avoided by including a single blank in such cases. The fix: SC92072. ---------------- 92/3/16 ----------------------------------------------- The code necessary for supporting access to SFS files is now included in the Kermit-CMS source, but it is by-passed by default via conditional assembly (since it includes references to symbols that are not defined in CMS releases before 6). Kermit-CMS is now able to reject a file that is too large to fit in the destination SFS directory. Enabling the code is done by selecting the appropriate CNTRL file when applying the updates (see part C above). The fix: SC92076. ---------------- 92/3/25 ----------------------------------------------- Kermit protocol now includes a special checksum type called BLANK-FREE-2 intended to avoid the possibility of multiple blanks in Kermit packets. This can be necessary in FULLSCREEN mode for certain types of protocol converter, such as the MICOM 7400. The fix: SC92085. ---------------- 92/4/21 ----------------------------------------------- Kermit-CMS left an SCBLOCK in effect each time it was invoked. CMS 5 automatically releases SCBLOCKs when the driving program exits, but earlier releases of CMS did not; thus, Kermit would both waste memory and risk invalid calls to the Kermit subcommand environment. Now, Kermit-CMS releases the SCBLOCK explicitly. The fix: SC92112. ---------------- 92/4/22 ----------------------------------------------- Kermit-370 now supports synonym CP1047 for the default file character set EBCDIC, following IBM recognition of the de facto standard and the registration of that character set. The fix: SC92113. ---------------- 92/4/29 ----------------------------------------------- Kermit-370 has changed the calling sequence of the KERMAIL, KERMPRT, and KERMSUB commands that it invokes in support of local mail, print, and job submission. At the first invocation (for verifying that the desired operation is feasible), Kermit passes a dummy filespec consisting of the single character "." instead of passing none at all. The fix: SC92120. Locally developed EXEC's should be changed accordingly. See the new distribution file IKCAUX.CMD for examples of EXEC's that are backward- compatible. ---------------- 92/5/13 ----------------------------------------------- Kermit-CMS is now at level 4.2.3. The fix: SC92134. ---------------- 92/6/10 ----------------------------------------------- Kermit-370 now appends an extra message to the normal protocol-mode greetings, provided DELAY is at least 2. The extra message is of the form "KERMIT READY TO SEND..." (or RECEIVE or SERVE). The fix: SC92161. ---------------- 92/6/17 ----------------------------------------------- Kermit-370 has a new TDUMP option available when the assembly-time TRACE option is enabled. Specifying TDUMP TRACE prints a dump of the trace table. Note that the new option is permitted only if TRACE is enabled. The fix: SC92169. ---------------- 92/6/26 ----------------------------------------------- In order to satisfy the restrictions of the F assembler (still used at many sites running CICS under VSE), the TITLE and PRINT ops at the start of open code have been moved after the definitions of global variable symbols. The fix: SC92178. ---------------- 92/6/28 ----------------------------------------------- Kermit-CMS can now log extra debug info for TTY and FULLSCREEN modes -- the I/O, LONG, and TIME options are fully supported, just as in the the transparent modes. The fix: SC92180. ---------------- 92/7/28 ----------------------------------------------- The error code, if any, after a SEND or RECEIVE is now made available to the accounting exit, if any. The variables ERROR and REASON have been moved to the end of the data block already known to exits. Kermit-CMS is now at level 4.2.5. The fix: SC92210. ---------------- 92/8/20 ----------------------------------------------- Kermit-370 now supports the Thai character set. The fix: SC92233. ---------------- 92/8/21 ----------------------------------------------- Kermit-CMS now checks available disk space more accurately. The fix: SC92234. ---------------- 92/9/16 ----------------------------------------------- Kermit-CMS no longer goes into an infinite loop if a TAKE file invokes itself. The fix: SC92260. ---------------- 92/12/15 ---------------------------------------------- Kermit may skip over some members of SFS directories if invoked from within an EXEC that does file I/O. Invoking Kermit from the CMS command line prevents the problem, as does the following fix: ./ * SC92350 - Skip over null FST's with SFS (CMS) ./ R 06329000 06332000 $ 6329000 1000 12/15/92 18:13:07 NXFFST CLI FSTN,0 Check if DIRECTORY or map @SC92350 BE NXFNFST Skip if so (or other garbage) @SC92350 ---------------- 92/12/17 ---------------------------------------------- Kermit-370 now uses TTABLE logic for both the DEBUG and SIM subcommands. The fix: SC92352. ---------------- 93/1/14 ----------------------------------------------- Kermit-370 now prints a nominal efficiency rating in the STATUS report if SPEED is defined. The fix: SC93014. ------------------------------------------------------------------------